home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.1 / mimencode.1 < prev    next >
Text File  |  1995-07-25  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))     BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           mimencode - Translate to and from mail-oriented encoding
  10.           formats
  11.  
  12.           (Same program also installed as "mmencode".)
  13.  
  14.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  15.           mmmmiiiimmmmeeeennnnccccooooddddeeee[-u] [-b] [-q] [-p] [file name]
  16.  
  17.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  18.           The _m_i_m_e_n_c_o_d_e program simply converts a byte stream into (or
  19.           out of) one of the standard mail encoding formats defined by
  20.           MIME, the proposed standard for internet multimedia mail
  21.           formats.  Such an encoding is necessary because binary data
  22.           cannot be sent through the mail.  The encodings understood
  23.           by mimencode are preferable to the use of the
  24.           uuencode/uudecode programs, for use in mail, in several
  25.           respects that were important to the authors of MIME.
  26.  
  27.           By default, mimencode reads standard input, and sends a
  28.           "base64" encoded version of the input to standard output.
  29.  
  30.           The (really not necessary) "-b" option tells mimencode to
  31.           use the "base64" encoding.
  32.  
  33.           The "-q" option tells mimencode to use the "quoted-
  34.           printable" encoding instead of base64.
  35.  
  36.           The "-u" option tells mimencode to _d_e_c_o_d_e the standard input
  37.           rather than encode it.
  38.  
  39.           The "-p" option tells mimencode to translate decoded CRLF
  40.           sequences into the local newline convention during decoding
  41.           and to do the reverse during encoding.  This option is only
  42.           meaningful when  -b (base64 encoding) is in effect.
  43.  
  44.           If a file name argument is given, input is read from that
  45.           file rather than from standard input.
  46.  
  47.      RRRRAAAATTTTIIIIOOOONNNNAAAALLLLEEEE
  48.           _M_i_m_e_n_c_o_d_e is intended to be a replacement for _u_u_e_n_c_o_d_e for
  49.           mail and news use.  The reason is simple:  uuencode doesn't
  50.           work very well in a number of circumstances and ways.  In
  51.           particular, uuencode uses characters that don't translate
  52.           well across all mail gateways (particularly ASCII <-> EBCDIC
  53.           gateways).  Also, uuencode is not standard -- there are
  54.           several variants floating around, encoding and decoding
  55.           things in different and incompatible ways, with no
  56.           "standard" on which to base an implementation.  Finally,
  57.           uuencode does not generally work well in a pipe, although
  58.           some variants have been modified to do so.  Mimencode
  59.           implements the encodings which were defined for MIME as
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/30/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))     BBBBeeeellllllllccccoooorrrreeee PPPPrrrroooottttoooottttyyyyppppeeee ((((RRRReeeelllleeeeaaaasssseeee 1111))))      MMMMIIIIMMMMEEEENNNNCCCCOOOODDDDEEEE((((1111))))
  71.  
  72.  
  73.  
  74.           uuencode replacements, and should be considerably more
  75.           robust for email use.
  76.  
  77.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  78.           metamail(1), mailto(1)
  79.  
  80.      BBBBUUUUGGGGSSSS
  81.           This program was originally distributed as "mmencode".  That
  82.           name turns out to conflict with a program of the same name
  83.           that is part of the Slate software from BBN, but totally
  84.           changing the name to mimencode would create other problems
  85.           (notably with portability to systems where the left half of
  86.           file names is limited to 8 characters).  Currently, it is
  87.           being distributed with links under BOTH names.  The programs
  88.           in the distribution that call the program all call it as
  89.           "mimencode", so the "mmencode" version may be deleted at
  90.           sites where it causes a problem.  (The source files are
  91.           still named "mmencode" rather than "mimencode".)
  92.  
  93.      CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
  94.           Copyright (c) 1991 Bell Communications Research, Inc.
  95.           (Bellcore)
  96.  
  97.           Permission to use, copy, modify, and distribute this
  98.           material for any purpose and without fee is hereby granted,
  99.           provided that the above copyright notice and this permission
  100.           notice appear in all copies, and that the name of Bellcore
  101.           not be used in advertising or publicity pertaining to this
  102.           material without the specific, prior written permission of
  103.           an authorized representative of Bellcore.  BELLCORE MAKES NO
  104.           REPRESENTATIONS ABOUT THE ACCURACY OR SUITABILITY OF THIS
  105.           MATERIAL FOR ANY PURPOSE.  IT IS PROVIDED "AS IS", WITHOUT
  106.           ANY EXPRESS OR IMPLIED WARRANTIES.
  107.  
  108.      AAAAUUUUTTTTHHHHOOOORRRR
  109.           Nathaniel S. Borenstein
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/30/95)
  130.  
  131.  
  132.  
  133.